home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / dates406.zip / DATES.DOC < prev    next >
Text File  |  1994-06-18  |  4KB  |  99 lines
  1. DATES.DOC
  2. 06/18/94
  3.  
  4. This program keeps track of birthdays, anniversaries, coming events, etc giving
  5. you advance warning so you can send out cards, leave town, etc.  By default, the
  6. warning is for any event happening in the next 14 days but you can change this
  7. if you want.
  8.  
  9. This program can be included in your AUTOEXEC.BAT file to provide notices
  10. every time you turn on your PC.
  11.  
  12. The input file for this program is typically called DATES.TXT but it can be
  13. anything.  The file is a simple ASCII text file, maintained with any text
  14. editor, that contains date records in the following format:
  15.  
  16.         cols  1- 8 date in mm/dd/yy format
  17.              10-on description of event
  18.  
  19. Any blank line or any line which begins with a semi-colon is ignored by the
  20. program.
  21.  
  22. For the date itself, all characters are required and fields should be
  23. 0-filled if necessary (e.g. use "01/01/92" instead of "1/1/92").  The month
  24. *has* to be filled in.  The day and year portions can be "xx" if desired.  If a
  25. day is "xx", you will be given the notice for the entire month and for 15 days
  26. before the start of the month.
  27.  
  28. For dates which vary from year to year (e.g. Thanksgiving), you can either use
  29. the "xx" option for the day or revise the file every year.
  30.  
  31. Records in the file don't have to be in any particular order but dates are
  32. presented in the order they appear in the file so putting them in chronological
  33. order makes the most sense.
  34.  
  35. A sample DATES.TXT file is provided and consists of the following lines:
  36.  
  37.         01/01/xx New Year's Day
  38.         01/15/xx Est tax due
  39.         04/15/xx Est tax due + regular taxes
  40.         05/10/xx -ish Mother's Day
  41.         05/30/xx -ish Memorial Day
  42.         05/31/57 Bruce Guthrie
  43.         06/15/xx Est tax due
  44.         06/15/xx -ish Father's Day
  45.         07/04/xx July 4th
  46.         09/15/xx Est tax due
  47.         11/xx/xx Thanksgiving
  48.         11/11/xx Veteran's Day
  49.         12/25/xx Christmas
  50.  
  51.  
  52. Syntax:
  53.  
  54.     DATES date_file [ days | /Ddays ] [ /-A | /A ] [ /? ]
  55.  
  56. where:
  57.  
  58. "date_file" is the name of the input text file.  It can contain drive and path
  59. information if desired.  This defaults to DATES.TXT.
  60.  
  61. "days" (or "/Ddays") are the number of days in advance you want the warning.
  62. Defaults to 14.  Note that generic days ("11/xx/xx") are not affected by this
  63. setting; you automatically get the notice 14 days before the beginning of the
  64. month.
  65.  
  66. "/A" shows the age of the event when it's printed.  This is only done for
  67. entries that have a specific year.  This is the default.
  68.  
  69. "/-A" skips showing the age of the event.  The default is /A.
  70.  
  71. "/?" or "/HELP" or "HELP" gives you syntactical help.
  72.  
  73.  
  74. Writer:
  75.  
  76. This program was written by Bruce Guthrie of Wayne Software.  It is free for use
  77. and redistribution provided relevant documentation is kept with the program, no
  78. changes are made to the program or documentation, and it is not bundled with
  79. commercial programs or charged for separately.  People who need to bundle it in
  80. for-sale packages must pay a $50 registration fee to "Wayne Software" at the
  81. following address.
  82.  
  83. Additional information about this and other Wayne Software programs can be found
  84. in the file BRUCEymm.DOC which should be included in the original ZIP file.
  85. ("ymm" is replaced by the last digit of the year and the two digit month of the
  86. release.  BRUCE312.DOC came out in December 1993.  This same naming convention
  87. is used in naming the ZIP file that this program was included in.) Comments and
  88. suggestions can also be sent to:
  89.  
  90.                 Bruce Guthrie
  91.                 Wayne Software
  92.                 113 Sheffield St.
  93.                 Silver Spring, MD 20910
  94.  
  95.                 fax: (301) 588-8986
  96.  
  97. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  98.  
  99.